The Customization ('cust') Resource(IM:XP)

Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 6 - Printing Resources / Printing Resources Reference

Resources Used Only in Printer Drivers

The Customization ('cust') Resource
The driver customization ('cust') resource, of type gxCustType, tells QuickDraw GX how to support the use of your printer driver by Macintosh Printing Manager applications. It defines values that help QuickDraw GX to translate Macintosh Printing Manager calls into messages for your printer driver. If you do not include a customization resource for your driver, a default version is used by QuickDraw GX. The default version works well for most drivers. Figure 6-16 shows the structure of a customization resource.
Figure 6-16 The customization resource

The customization resource defines the following:

Horizontal resolution. The horizontal resolution to use for the device in dots per inch (dpi).
Vertical resolution. The vertical resolution to use for the device in dots per inch.
Macintosh Printing Manager interface type. The style of Macintosh Printing Manager interface driver with which your driver is compatible. Constants for this field are shown in Table 6-20.
Pattern stretch factor. A point that indicates how to scale bitmap patterns when printing.
Translator settings. Settings for translating Macintosh Printing Manager driver calls into messages for your driver. Constants for the translator setting values, which you can combine together into a single value, are shown in Table 6-21.

Table 6-20 shows the constants that you can use to specify the updriver type in customization resources.
Table 6-20 Updriver values for the customization resource
Constant Value Explanation
defaultUpDriver 0 LaserWriter interface
laserWriter 0 LaserWriter interface
laserWriterSC 1 LaserWriter SC interface

Table 6-21 shows the constants that you can use to specify translator settings in customization resources.
Table 6-21 Translator setting values
Constant Value Explanation
gxDefaultOptionsTranslation 0x0000 These default settings produce the most accurate representation of the QuickDraw data.
gxOptimizedTranslation 0x0001 The translator fills in the center of outline text shapes that are drawn in srcOr mode with white, producing the same effect as black-and-white QuickDraw.
gxReplaceLineWidthTranslation 0x0002 The line width specified in the PostScript SetLineWidth command becomes the new line width. The default (without this option) is to scale the line width by the specified value.
gxSimpleScalingTranslation 0x0004 The translator scales data via a simple multiply, without compensating for increased resolution. The resulting scaled image is similar to what QuickDraw would have produced when it scaled the data.
gxSimpleGeometryTranslation 0x0008 The translator translates QuickDraw data without taking into account the QuickDraw hanging pen. The translator does not reproduce the QuickDraw 6-sided line and 7-sided triangle. This means faster drawing with QuickDraw GX with some loss of accuracy.
This option turns on the gxSimpleScalingTranslation option.
gxSimpleLinesTranslation 0x000C The translator maintains the width of lines when lines are at an angle, rather than producing a thicker diagonal line. With this option, line width is the same as pen width.
This option turns on the simpleScalingTranslation and simpleGeometryTranslation options.
gxLayoutTextTranslation 0x0010 The translator allows layout to perform default substitutions, which produce text that is more attractive than, but different from, the original QuickDraw text.
gxRasterTargetTranslation 0x0020 The translator produces output for a raster device.
gxPostScriptTargetTranslation 0x0040 The translator produces output for a PostScript device.

The customization resource ID needs to be the constant gxCustID (-8192). Listing 6-14 shows an example of a customization resource for the ImageWriter II printer driver, which uses the optimized translation settings and scales bitmaps by a factor of 2 both horizontally and vertically.
Listing 6-14 An example of a customization resource
resource gxCustType (gxCustID, sysHeap, purgeable)
{
   144, 144,      /* 144 dpi device */
   defaultUpDriver,     /* use default upDriver */
   {2,2},               /* pattern scaling (144dpi/72dpi)*/
   gxOptimizedTranslation/* use optimized translator settings */
};

**Table 6-20 Updriver values for the customization resource**
Constant	Value	Explanation
`defaultUpDriver`	0	LaserWriter interface
`laserWriter`	0	LaserWriter interface
`laserWriterSC`	1	LaserWriter SC interface

**Table 6-21 Translator setting values**
Constant	Value	Explanation
`gxDefaultOptionsTranslation`	0x0000	These default settings produce the most accurate representation of the QuickDraw data.
`gxOptimizedTranslation`	0x0001	The translator fills in the center of outline text shapes that are drawn in `srcOr` mode with white, producing the same effect as black-and-white QuickDraw.
`gxReplaceLineWidthTranslation`	0x0002	The line width specified in the PostScript `SetLineWidth` command becomes the new line width. The default (without this option) is to scale the line width by the specified value.
`gxSimpleScalingTranslation`	0x0004	The translator scales data via a simple multiply, without compensating for increased resolution. The resulting scaled image is similar to what QuickDraw would have produced when it scaled the data.
`gxSimpleGeometryTranslation`	0x0008	The translator translates QuickDraw data without taking into account the QuickDraw hanging pen. The translator does not reproduce the QuickDraw 6-sided line and 7-sided triangle. This means faster drawing with QuickDraw GX with some loss of accuracy. This option turns on the `gxSimpleScalingTranslation` option.
`gxSimpleLinesTranslation`	0x000C	The translator maintains the width of lines when lines are at an angle, rather than producing a thicker diagonal line. With this option, line width is the same as pen width. This option turns on the `simpleScalingTranslation` and `simpleGeometryTranslation` options.
`gxLayoutTextTranslation`	0x0010	The translator allows layout to perform default substitutions, which produce text that is more attractive than, but different from, the original QuickDraw text.
gxRasterTargetTranslation	0x0020	The translator produces output for a raster device.
gxPostScriptTargetTranslation	0x0040	The translator produces output for a PostScript device.